Scenario #6010: Replace Deceased Partner by Community of Heirs

Properties

Required

Given

name value
partnerNumber P-31011
dateOfDeath 2024-11-15
representativeGivenName Lena
representativeFamilyName Stadland
communityOfHeirsPostalAddress “street”: “Im Wischer 14”,
“zipcode”: “22987”,
“city”: “Hamburg”,
“country”: “Germany”
communityOfHeirsOfficePhoneNumber +49 40 666666
communityOfHeirsEmailAddress lena.stadland@example.org

Partner: P-31011

HTTP GET "/api/hs/office/partners/P-31011" \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }`
=> status: 200 OK 
{
  "uuid" : "f53178c3-bd59-4c7a-ba1a-c6a96ff281db", // Partner: P-31011 - Michelle Matthieu
  "partnerNumber" : "P-31011",
  "partnerRel" : {
    "uuid" : "dc7d5a82-2a3b-4523-a002-9f439903892a",
    "anchor" : {
      "uuid" : "806e75fe-7894-4422-86be-783107f07f3f", // Person: Hostsharing eG
      "personType" : "LEGAL_PERSON",
      "tradeName" : "Hostsharing eG",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "holder" : {
      "uuid" : "85489e3f-ec95-4785-9d99-c0eecf7a1593", // personUuid
      "personType" : "NATURAL_PERSON",
      "tradeName" : null,
      "salutation" : null,
      "title" : null,
      "givenName" : "Michelle",
      "familyName" : "Matthieu-Zhang"
    },
    "type" : "PARTNER",
    "mark" : null,
    "contact" : {
      "uuid" : "2a4d0f8c-a478-405b-9875-2a6a4474e9c5", // Contact: Michelle Matthieu
      "caption" : "Michelle Matthieu",
      "postalAddress" : {
        "zipcode" : "22123",
        "country" : "Germany",
        "city" : "Hamburg",
        "street" : "An der Wandse 34",
        "name" : "Michelle Matthieu"
      },
      "emailAddresses" : {
        "main" : "michelle@matthieu.example.org"
      },
      "phoneNumbers" : {
        "mobile" : "+49 152 1234567"
      }
    }
  },
  "details" : {
    "uuid" : "13210be8-6649-4fa7-8cb6-6284dc3b4d64",
    "registrationOffice" : null,
    "registrationNumber" : null,
    "birthName" : "Eichbaum",
    "birthPlace" : "Neustadt a.d.R.",
    "birthday" : "1951-03-25",
    "dateOfDeath" : null
  }
}

Even in production data we expect this query to return just a single result.

New Partner-Person+Contact: Erbengemeinschaft Michelle Matthieu-Zhang

HTTP PATCH "/api/hs/office/partners/f53178c3-bd59-4c7a-ba1a-c6a96ff281db" // Partner: P-31011 \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }` \
  <<EOF
{
  "partnerRel" : {
    "holder" : {
      "personType" : "UNINCORPORATED_FIRM",
      "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang"
    },
    "contact" : {
      "caption" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "postalAddress" : {
        "whatever" : "any key is allowed here",
        "name" : "Erbengemeinschaft Michelle Matthieu-Zhang",
        "co" : "Lena Stadland",
        "street" : "Im Wischer 14",
        "zipcode" : "22987",
        "city" : "Hamburg",
        "country" : "Germany"
      },
      "phoneNumbers" : {
        "office" : "+49 40 666666"
      },
      "emailAddresses" : {
        "main" : "lena.stadland@example.org"
      }
    }
  }
}
EOF
=> status: 200 OK 
{
  "uuid" : "f53178c3-bd59-4c7a-ba1a-c6a96ff281db", // Partner: P-31011
  "partnerNumber" : "P-31011",
  "partnerRel" : {
    "uuid" : "dc7d5a82-2a3b-4523-a002-9f439903892a",
    "anchor" : {
      "uuid" : "806e75fe-7894-4422-86be-783107f07f3f", // Person: Hostsharing eG
      "personType" : "LEGAL_PERSON",
      "tradeName" : "Hostsharing eG",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "holder" : {
      "uuid" : "49ece8d6-4b87-47d0-b092-2248a8d79103",
      "personType" : "UNINCORPORATED_FIRM",
      "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "type" : "PARTNER",
    "mark" : null,
    "contact" : {
      "uuid" : "b4b67e3c-873b-4e5c-b9f3-96d2a89bbbb3",
      "caption" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "postalAddress" : {
        "zipcode" : "22987",
        "country" : "Germany",
        "city" : "Hamburg",
        "street" : "Im Wischer 14",
        "name" : "Erbengemeinschaft Michelle Matthieu-Zhang",
        "co" : "Lena Stadland",
        "whatever" : "any key is allowed here"
      },
      "emailAddresses" : {
        "main" : "lena.stadland@example.org"
      },
      "phoneNumbers" : {
        "office" : "+49 40 666666"
      }
    }
  },
  "details" : {
    "uuid" : "13210be8-6649-4fa7-8cb6-6284dc3b4d64",
    "registrationOffice" : null,
    "registrationNumber" : null,
    "birthName" : "Eichbaum",
    "birthPlace" : "Neustadt a.d.R.",
    "birthday" : "1951-03-25",
    "dateOfDeath" : null
  }
}

Representative-Relation: Lena Stadland for Erbengemeinschaft Michelle Matthieu-Zhang

HTTP POST "/api/hs/office/relations" \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }` \
  <<EOF
{
  "type" : "REPRESENTATIVE",
  "anchor.uuid" : "49ece8d6-4b87-47d0-b092-2248a8d79103", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
  "holder" : {
    "personType" : "NATURAL_PERSON",
    "givenName" : "Lena",
    "familyName" : "Stadland"
  },
  "contact.uuid" : "b4b67e3c-873b-4e5c-b9f3-96d2a89bbbb3" // Contact: Erbengemeinschaft Michelle Matthieu-Zhang
}
EOF
=> status: 201 CREATED 4652215b-be71-4ac9-975b-7d51f3ac0f79
{
  "uuid" : "4652215b-be71-4ac9-975b-7d51f3ac0f79",
  "anchor" : {
    "uuid" : "49ece8d6-4b87-47d0-b092-2248a8d79103", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
    "personType" : "UNINCORPORATED_FIRM",
    "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
    "salutation" : null,
    "title" : null,
    "givenName" : null,
    "familyName" : null
  },
  "holder" : {
    "uuid" : "071ec43d-fc36-44a1-a1e8-0eb129b3df1f",
    "personType" : "NATURAL_PERSON",
    "tradeName" : null,
    "salutation" : null,
    "title" : null,
    "givenName" : "Lena",
    "familyName" : "Stadland"
  },
  "type" : "REPRESENTATIVE",
  "mark" : null,
  "contact" : {
    "uuid" : "b4b67e3c-873b-4e5c-b9f3-96d2a89bbbb3", // Contact: Erbengemeinschaft Michelle Matthieu-Zhang
    "caption" : "Erbengemeinschaft Michelle Matthieu-Zhang",
    "postalAddress" : {
      "zipcode" : "22987",
      "country" : "Germany",
      "city" : "Hamburg",
      "street" : "Im Wischer 14",
      "name" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "co" : "Lena Stadland",
      "whatever" : "any key is allowed here"
    },
    "emailAddresses" : {
      "main" : "lena.stadland@example.org"
    },
    "phoneNumbers" : {
      "office" : "+49 40 666666"
    }
  }
}

Verify the Updated Partner

HTTP GET "/api/hs/office/partners/P-31011" \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }`
=> status: 200 OK 
{
  "uuid" : "f53178c3-bd59-4c7a-ba1a-c6a96ff281db", // Partner: P-31011
  "partnerNumber" : "P-31011",
  "partnerRel" : {
    "uuid" : "dc7d5a82-2a3b-4523-a002-9f439903892a",
    "anchor" : {
      "uuid" : "806e75fe-7894-4422-86be-783107f07f3f", // Person: Hostsharing eG
      "personType" : "LEGAL_PERSON",
      "tradeName" : "Hostsharing eG",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "holder" : {
      "uuid" : "49ece8d6-4b87-47d0-b092-2248a8d79103", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
      "personType" : "UNINCORPORATED_FIRM",
      "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "type" : "PARTNER",
    "mark" : null,
    "contact" : {
      "uuid" : "b4b67e3c-873b-4e5c-b9f3-96d2a89bbbb3", // Contact: Erbengemeinschaft Michelle Matthieu-Zhang
      "caption" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "postalAddress" : {
        "zipcode" : "22987",
        "country" : "Germany",
        "city" : "Hamburg",
        "street" : "Im Wischer 14",
        "name" : "Erbengemeinschaft Michelle Matthieu-Zhang",
        "co" : "Lena Stadland",
        "whatever" : "any key is allowed here"
      },
      "emailAddresses" : {
        "main" : "lena.stadland@example.org"
      },
      "phoneNumbers" : {
        "office" : "+49 40 666666"
      }
    }
  },
  "details" : {
    "uuid" : "13210be8-6649-4fa7-8cb6-6284dc3b4d64",
    "registrationOffice" : null,
    "registrationNumber" : null,
    "birthName" : "Eichbaum",
    "birthPlace" : "Neustadt a.d.R.",
    "birthday" : "1951-03-25",
    "dateOfDeath" : null
  }
}

Verify the Ex-Partner-Relation

HTTP GET "/api/hs/office/relations?relationType=EX_PARTNER&personUuid=85489e3f-ec95-4785-9d99-c0eecf7a1593" // Person: Michelle Matthieu-Zhang \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }`
=> status: 200 OK 
[ {
  "uuid" : "24d24c4d-c067-42e7-8065-e4ab86ad43e4",
  "anchor" : {
    "uuid" : "49ece8d6-4b87-47d0-b092-2248a8d79103", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
    "personType" : "UNINCORPORATED_FIRM",
    "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
    "salutation" : null,
    "title" : null,
    "givenName" : null,
    "familyName" : null
  },
  "holder" : {
    "uuid" : "85489e3f-ec95-4785-9d99-c0eecf7a1593", // Person: Michelle Matthieu-Zhang
    "personType" : "NATURAL_PERSON",
    "tradeName" : null,
    "salutation" : null,
    "title" : null,
    "givenName" : "Michelle",
    "familyName" : "Matthieu-Zhang"
  },
  "type" : "EX_PARTNER",
  "mark" : null,
  "contact" : {
    "uuid" : "b4b67e3c-873b-4e5c-b9f3-96d2a89bbbb3", // Contact: Erbengemeinschaft Michelle Matthieu-Zhang
    "caption" : "Erbengemeinschaft Michelle Matthieu-Zhang",
    "postalAddress" : {
      "zipcode" : "22987",
      "country" : "Germany",
      "city" : "Hamburg",
      "street" : "Im Wischer 14",
      "name" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "co" : "Lena Stadland",
      "whatever" : "any key is allowed here"
    },
    "emailAddresses" : {
      "main" : "lena.stadland@example.org"
    },
    "phoneNumbers" : {
      "office" : "+49 40 666666"
    }
  }
} ]

Verify the Representative-Relation

HTTP GET "/api/hs/office/relations?relationType=REPRESENTATIVE&personUuid=49ece8d6-4b87-47d0-b092-2248a8d79103" // Person: Erbengemeinschaft Michelle Matthieu-Zhang \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }`
=> status: 200 OK 
[ {
  "uuid" : "4652215b-be71-4ac9-975b-7d51f3ac0f79", // Representative-Relation: Lena Stadland for Erbengemeinschaft Michelle Matthieu-Zhang
  "anchor" : {
    "uuid" : "49ece8d6-4b87-47d0-b092-2248a8d79103", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
    "personType" : "UNINCORPORATED_FIRM",
    "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
    "salutation" : null,
    "title" : null,
    "givenName" : null,
    "familyName" : null
  },
  "holder" : {
    "uuid" : "071ec43d-fc36-44a1-a1e8-0eb129b3df1f", // Person: Lena Stadland
    "personType" : "NATURAL_PERSON",
    "tradeName" : null,
    "salutation" : null,
    "title" : null,
    "givenName" : "Lena",
    "familyName" : "Stadland"
  },
  "type" : "REPRESENTATIVE",
  "mark" : null,
  "contact" : {
    "uuid" : "b4b67e3c-873b-4e5c-b9f3-96d2a89bbbb3", // Contact: Erbengemeinschaft Michelle Matthieu-Zhang
    "caption" : "Erbengemeinschaft Michelle Matthieu-Zhang",
    "postalAddress" : {
      "zipcode" : "22987",
      "country" : "Germany",
      "city" : "Hamburg",
      "street" : "Im Wischer 14",
      "name" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "co" : "Lena Stadland",
      "whatever" : "any key is allowed here"
    },
    "emailAddresses" : {
      "main" : "lena.stadland@example.org"
    },
    "phoneNumbers" : {
      "office" : "+49 40 666666"
    }
  }
} ]

Verify the Debitor-Relation

HTTP GET "/api/hs/office/debitors?partnerNumber=P-31011" \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }`
=> status: 200 OK 
[ {
  "uuid" : "7bc3c36a-c1c0-483f-8121-9173ff167ab8", // Debitor: D-3101100 - Michelle Matthieu
  "debitorRel" : {
    "uuid" : "b9f05bf3-6607-4d6e-b8c4-08455828c50d",
    "anchor" : {
      "uuid" : "49ece8d6-4b87-47d0-b092-2248a8d79103", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
      "personType" : "UNINCORPORATED_FIRM",
      "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "holder" : {
      "uuid" : "49ece8d6-4b87-47d0-b092-2248a8d79103", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
      "personType" : "UNINCORPORATED_FIRM",
      "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "type" : "DEBITOR",
    "mark" : null,
    "contact" : {
      "uuid" : "2a4d0f8c-a478-405b-9875-2a6a4474e9c5", // Contact: Michelle Matthieu
      "caption" : "Michelle Matthieu",
      "postalAddress" : {
        "zipcode" : "22123",
        "country" : "Germany",
        "city" : "Hamburg",
        "street" : "An der Wandse 34",
        "name" : "Michelle Matthieu"
      },
      "emailAddresses" : {
        "main" : "michelle@matthieu.example.org"
      },
      "phoneNumbers" : {
        "mobile" : "+49 152 1234567"
      }
    }
  },
  "debitorNumber" : "D-3101100",
  "debitorNumberSuffix" : "00",
  "partner" : {
    "uuid" : "f53178c3-bd59-4c7a-ba1a-c6a96ff281db", // Partner: P-31011
    "partnerNumber" : "P-31011",
    "partnerRel" : {
      "uuid" : "dc7d5a82-2a3b-4523-a002-9f439903892a",
      "anchor" : {
        "uuid" : "806e75fe-7894-4422-86be-783107f07f3f", // Person: Hostsharing eG
        "personType" : "LEGAL_PERSON",
        "tradeName" : "Hostsharing eG",
        "salutation" : null,
        "title" : null,
        "givenName" : null,
        "familyName" : null
      },
      "holder" : {
        "uuid" : "49ece8d6-4b87-47d0-b092-2248a8d79103", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
        "personType" : "UNINCORPORATED_FIRM",
        "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
        "salutation" : null,
        "title" : null,
        "givenName" : null,
        "familyName" : null
      },
      "type" : "PARTNER",
      "mark" : null,
      "contact" : {
        "uuid" : "b4b67e3c-873b-4e5c-b9f3-96d2a89bbbb3", // Contact: Erbengemeinschaft Michelle Matthieu-Zhang
        "caption" : "Erbengemeinschaft Michelle Matthieu-Zhang",
        "postalAddress" : {
          "zipcode" : "22987",
          "country" : "Germany",
          "city" : "Hamburg",
          "street" : "Im Wischer 14",
          "name" : "Erbengemeinschaft Michelle Matthieu-Zhang",
          "co" : "Lena Stadland",
          "whatever" : "any key is allowed here"
        },
        "emailAddresses" : {
          "main" : "lena.stadland@example.org"
        },
        "phoneNumbers" : {
          "office" : "+49 40 666666"
        }
      }
    },
    "details" : {
      "uuid" : "13210be8-6649-4fa7-8cb6-6284dc3b4d64",
      "registrationOffice" : null,
      "registrationNumber" : null,
      "birthName" : "Eichbaum",
      "birthPlace" : "Neustadt a.d.R.",
      "birthday" : "1951-03-25",
      "dateOfDeath" : null
    }
  },
  "billable" : true,
  "vatId" : null,
  "vatCountryCode" : null,
  "vatBusiness" : false,
  "vatReverseCharge" : false,
  "refundBankAccount" : null,
  "defaultPrefix" : "mim"
} ]

generated on 2026-08-10 01:37:56 for branch